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CHAPTER 1 : INTRODUCTION 


The Cromemco Resident Operating System (ROS) allows the user to 
create and edit Z-80 source code, assemble the source code, and 
produce object code files. ROS resides in 8K bytes of memory space 
from address A000 to BFFF, 4 k bytes of system RAM are required 
from address D000 to DFFF. User RAM may reside anywhere else in 
memory space. 

ROS is available from Cromemco either on paper tape (model ZA-PT) 
or in PROM (model ZA-808). PROM may be used in the Cromemco 
8K Bytesaver# memory board (model 8KBS) or in the Cromemco l6K 
PROM board (model 16KPR). Loading instructions for the paper tape 
are given in Appendix I. 

Since you are no doubt anxious to begin using ROS right away, 
this chapter gives a detailed step-by-step example of the use 
of ROS in the composition, assembly, and execution of a program. 

Before attempting to use ROS be sure that you have RAM memory in 
your computer from location D000 to DFFF (e.g. a Cromemco model 
!+KZ memory hoard). This memory space is allocated for ROS system 
use. You will also need additional RAM in your system for storing 
your source code and the assembled object code. This is called 
the user RAM. For the purposes of the example, in this chapter it 
is assumed that there is 4 k of user RAM starting at location 
zero in memory. 

Once ROS is resident in your computer, begin program execution 
at memory location A000. Next follow through the example given 
in this chapter to learn how to use this powerful software system 
for program development . 



5 


AN ILLUSTRATIVE EXAMPLE 


Now let's consider a specific example of writing a 
Z-80 assembly language program, assembling the program, 
and executing the resultant machine code. 

The title of the program is "ECHO" . The purpose of 
the program is simply to input a character from a keyboard 
and echo it to a display. The program assumes standard 
Cromemco I/O convention of data exchange on I/O port 1 
with status information on input port 0. 

To begin we must execute the ROS program that begins 
at location A000 in memory. From the Cromemco Monitor 
this is accomplished by typing: 

G A000 

After executing ROS at location A000 depress Carriage Return 
on your console keyboard until the following response appears 
on your display: 


CROMEMCO ROS V.2.1 

Our assembly language source code will be stored 
as a "file" in the computer's memory. We must give a name 
to this file and snecify the memory addresses in which the 
file resides. This is accomplished with the CFIL command. 
Suppose that we name the file "ECHO" and wish to have 
the file begin at address 0100 in memory and extend no 
farther than location 09FF in memory. Such a file can be 
created by now entering this instruction from the keyboard: 

CFIL, ECHO, 100, 9FF 

After typing this and depressing carriage return on the 
keyboard, ROS will respond by stating the beginning and 
ending address of system memory now being used: 

D000 DlEB 

When entering our assembly language program from the 
keyboard we probably would prefer to be prompted with line 
numbers rather than manually type the line number of each 
line of the program ourself. It is common to begin with 
line number 10 and to increment each sucessive line number 
by 10. For automatic prompting of line numbers we type: 

AUTO, 10, 10 

ROS will then prompt us with the first line number (a 10) 
and we can proceed to enter the assembly language program. 
After each carriage return we will be prompted with the next 
line number. This is shown in the example on the following 
page . 



CRONEMCO REOS! 
JG AOOO 


CRQKEMCO ROS V.2.1 

CFIL# ECHO# ICO# 9FF 
DC CO DIES 

AUTO# 10# 10 

0010 ;this program echos the keyboard 
0020 ; 

0030 LE SP#OEOOH 
0040 START i CALL INPUT 
0050 CALL OUTPUT 
0060 JP START 
0070 ; 

0080 INPUTS IN A# C 

0090 BIT RDA# A 

0100 JR Z# INPUT 

0110 IN A# 1 # INPUT CHARACTER 

0120 RET 

0130 i 

0140 OUTPUT* PUSH AF # SAVE CHARACTER 

0150 IN A# 0 

0160 BIT TBE# A 

0170 JR Z# OUTPUT+ 1 

0180 POP AFJ RETRIEVE CHARACTER 

0190 OUT i# A 

0200 RET 

0210 RDA* EQU 6 

0220 TBE* EQU 7 

0230 


The above is a transcript of an actual session at 
a keyboard using ROS. At this point we may wish to have 
a formatted listing of our file. This can be done first 
by depressing ESC or ALT-MODE on the terminal keyboard 
to indicate that we are finished entering the assembly 
language program. Then we type: 

FORM 

LIST 

The resultant listing is shown on the next page. 
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FORM 

LIST 

CO 10 /THIS PROGRAM ECHOS THE KEYBOARD 


0020 

i 




0030 


LD 

SP/ 0E00H 


0040 

STARTs 

CALL 

INPUT 


0050 


CALL 

OUTPUT 


0060 


JP 

START 


0070 

• 

> 




0080 

INPUT: 

IN 

A/ 0 


0090 


BIT 

R DA/ A 


0100 


JR 

Z/ INPUT 


01 10 


IN 

A / i ; 

INPUT CHARACTER 

0120 


RET 



0130 

* 




0140 

OUTPUT: 

PUSH 

af ; 

SAVE CHARACTER 

015b 


IN 

A / 0 


0160 


BIT 

TBE/ A 


0170 


JR 

Z/ OUTPUT* 1 


0180 


POP 

AF ; 

RETRIEVE CHARACTER 

0190 


OUT 

1/ A 


0200 


RET 



0210 

RDAs 

EQU 

6 


0220 

TBE : 

EQU 

7 



This formatted listing of the assembly language 
source code is produced by ROS following the FORM and 
LIST commands as shown. 
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The assembly language program shown on the preceding 
page is composed in the following way. Each line of the 
assembly language code is made up of as many as five separate 
items. The first item is the line number . In AUTO mode 
ROS automatically supplies sucessive line numbers as we 
enter the program. The second item that may appear on a 
line is the label . If the line does have a label it is 
always followed by a colon. The third item that may appear 
is the instruction mnemonic . The mnemonics for the various 
Z-80 instructions can be found in the Z-80 CPU TECHNICAL 
MANUAL published by Mostek and Zilog.* The fourth item 
that may appear on a line is the operand or operands of the 
instruction. The first operand to appear must be separated 
from the instruction mnemonic by at least one space. If 
there is more than one operand the operands must be separated 
by commas. The last item that may appear on a line is a 
comment . A comment must always be preceded by a semi-colon. 

Now that we have created a file and entered our 
assembly language program we are ready to assemble the 
program. We indicate to ROS that we are finished entering 
the assembly language program by depressing the ESC or 
ALT-MODE key on our terminal. To get a formatted assembly 
output listing we type the command: 

FORM 

The command to assemble ( ASMB) is followed by three parameters 
to specify: l)the address at which the machine code is to be 
executed, 2) the address at which the machine code is to 
be put after assembly, and 3)an option code. (See Chapter 2 
Section 6 of ROS manual for more details) . Suppose we wish 
to have the machine code that results from our assembly be 
executable beginning at location 0 in memory. Suppose 
we also wish to have the actual machine code stored at location 
0 in memory following assembly. And say we wish a full 
assembly listing (option 1) . Then the command to assemble 
our assembly language file is given by: 

ASMB, 0,0,1 

After typing this command from our keyboard the assembly 
will procede, and an assembly listing will be produced as 
shown on the following page. 


* Note: Some manuals may show the following commands in this way: 

ADC A, s ; ADD A,n; ADD A,r; ADD A,(HL); ADD A,(lX+d); ADD A,(lY+d); 
SBC A,s; IN A,(n); OUT (n),A. In ROS, shorter versions of these 
commands are used as listed here: ADC s; ADD n; ADD r; ADD (HL); 
ADD ( IX+d ) ; ADD (iY+d); SBC s; IN A,n; OUT n,A. 



FORM 

ASMB, 0, 0, 1 
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CROMEMCO Z-SO ASSEMBLER V.2.0 


0000 




0010 

;this 

PROGRAM 

ECHOS THE KEYBOARD 

cooo 




0020 

• 

» 




0000 

31 

00 

0E 

0030 


LD 

SP> 0E00H 


0003 

CD 

OC 

00 

0040 

START i 

CALL 

INPUT 


0006 

CD 

15 

00 

0050 


CALL 

OUTPUT 


0009 

C3 

03 

00 

0060 


JP 

START 


oooc 




0070 

• 

> 




oooc 

DB 

00 


0080 

INPUTS 

IN 

A, 0 


000E 

CB 

77 


0090 


BIT 

RDA, A 


0010 

28 

FA 


0100 


JR 

Z> INPUT 


0012 

DB 

01 


0110 


IN 

A, 1 J 

INPUT CHARACTER 

00 1 4 

09 



0120 


RET 



0015 




0130 

i 




0015 

F5 



0140 

OUTPUT 

s PUSH 

AF 

SAVE CHARACTER 

0016 

DB 

00 


0150 


IN 

A, 0 


0018 

CB 

7F 


0160 


BIT 

TBE, A 


00 1 A 

28 

FA 


0170 


JR 

Z, 0UTPUT+ 1 


001C 

FI 



0180 


POP 

AF 

RETRIEVE CHARACTER 

00 ID 

D3 

01 


0190 


OUT 

1, A 


00 1 F 

C9 



0200 


RET 




0006 


0210 

RDAs 

EQU 

6 



0007 


0220 

TBEs 

EQU 

7 



ROS produces this assembly listing and stores the 
machine code object file at the location in memory specified 
by the ASMB command (in this case location 0) . There is a 
great deal of information on each line of this assembly 
listing as described on the next page. 
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r MEMORY ADDRESS 


rMEMORY CONTENTS 


•ERROR CODE 

("LINE NUMBER 


00 IB FI 


0180 


T—OP CODE MNEMONIC 
r OPERAND 

r COMMENT 


POP AF 


I RETRIEVE CHARACTER 


This example line from the assembly listing on the 
previous page shows that there are seven items of information 
that can reside on each line of the assembly listing. If 
the assembler detected an error in the composition . of the 
line then an error code would be inserted in the line at 
the position shown. The following error codes are used by 
ROS: 


Error Code 


Description 


A 

D 

L 

M 

O 

P 

R 

S 

U 

V 


Argument error 
Double definition 
Label error 
Missing label 
Op-code error 
Phase error 
Range error 
Syntax errcr 
Undefined 
Value error 
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PROGRAM EXECUTION 


After using the ASMB command to assemble this example program, 
you may wish to execute the program, this can he done by using the ROS 
command EXEC. Since we put the program at location zero in memory 
when we used the ASMB command, we would type EXEC,0. This causes 
an unconditional CALL to location zero saving the ROS return 
address on the stack. So now let's execute the example program 
and see if it works: 


EXEC, 0 

THIS IS A TEST OF THE PROGRAM ’'ECHO’'. AS I TYPE ON THE 
KEYBOARD IT IS ECHOED ON THE DISPLAY!!!! 


SUMMARY 


In this Chapter we have given one example of the use of 
Cromemco's ROS Assembler so that you can start using your copy 
of ROS right away. The following chapters describe the commands 
and conventions of ROS in much greater detail, and should 
answer any questions you had as you worked through this first 
example . 
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CHAPTER 2 : ROS COMMANDS 

Section 1 

FILE ORGANIZATION AND FILE COMMANDS 


File Organization 


Under ROS, user information is organized into files. The files 
are further subdivided into lines. The user is provided with a set of 
very comprehensive commands to manipulate his files. Another set of 
commands - the text editor - allows the user to reorganize the contents 
of his file, e.g. delete, replace, or insert an individual line. Each 
line in a memory file must be numbered. The lowest numbered line will 
always be placed at the beginning of a file, and numbering will con- 
tinue upward to the end of the file. 


File Command Formats 

In the formats given for each command the following conventions 
are used. If an entire word is capitalized, it is a key word and must 
be used. User supplied information is designated by lower case. A 
brace { } indicates the user must make a choice. Optional items are 
enclosed by brackets [ ] . The horizontal ellipsis . . . allows the item 

to be repeated. 

Example : 

c . .. (ending-file-address) 

CFIL , file-name, beginning-f lie-address , jf^xe-length ) 


File Naming 

A file name consists of one to six characters and can be any char- 
acter, (except a control character), for which a code exists. Thus, the 
file name #0AB41 is legal; however, it is recommended that names descrip- 
tive of the file content be used. An entry of a file name longer than 
six characters results in the first six characters being accepted as 
the file name. For example, an entry of MYNEWFILE gives MYNEWF as the 
file name. The number of user files is theoretically only limited by 
space available in the system RAM area. 


Active File - Current File 
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To avoid both the extra time involved in the user always having 
to specify which file is being manipulated and the system overhead in 
searching the RAM area, the concept of a current user file is intro- 
duced. Any file may be made current by use of the CURR command. Files 
are automatically current when they are created. 


Optional I/O Drivers 

Command, parameters, driver-name 

The ROS commands listed below have optional drivers associated 
with them. If the driver is omitted, then a default is made to SYS$00 - 
the system's I/O (console device). 

DUMP LCUS 

ECBN LEAD 

ECHX LFIL 

ENTE LIOD 

Example : 


l rsi , 10,20, TTY 
L IST, 10, 20, CRT2 


Create File 

CFIL, file-name, beginning-file-address, j f lie-length ~ ) 

The created file is entered in the File Name Table, which resides 
in the system RAM area. A newly created file becomes the current 
(active) file. All file commands which do not specifically designate 
a file default to the new file. After each file creation, the new 
boundaries of the system RAM are indicated. This reflects an entry 
into the File Name Table. An attempt to allocate previously assigned 
memory to a new file will result in the message: "MEMORY ALREADY 

ALLOCATED”. 

In several of the files created below some text will be entered. 
Each text line will be numbered by entering a number followed by a 
space. Variations on this procedure are given in the section on text 
commands . 

Example : 


LIST 

RBIN 

RCBN 

RCHX 


TEXT 

VJBIN 

WCBN 

WCHX 


List 

List 


on 

on 


TTY 

CRT2 


( <=»nrl i n n— F i "1 o — ar\r\ 7- ,=><=: =: 


CFIL, A, 1000, S1000 
D000 D20B 
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A is now the current file. It starts at 1000 hex and is allotted 
1000 hex locations; the limits of the file are 1000 to 1FFF . The system 
responds with the new RAM boundaries D000 D20B. Next, a new file is 
created. A is no longer current but remains in the File Name Table 
and can have data entered at any convenient time by making it current. 

Example : 


CHL. AIR, 2000, 2FFF 
DOOO D217 

10 FILE AIR BEGINS AT 2000 
20 ENDS AT 2FFF 

30 SUBSTITUTION OF SI 000 FOR 2FFF 
40 GIVES THE SAME RESULT 


Now an attempt is made to create a new file that extends into a 
previously allotted area. 


CF XL i TOMCAT, 2500, S300 
MFMORY ALREADY AL.LOCATED 


The files previously allotted are intact, and the file TOMCAT is 
non-existent. 


CF 1L, TOMCAT I ON, 3100, 31FF 
DOOO D223 


The file TOMCAT is now current. The remaining letters ION are 
ignored . 


List File Names 


LFIL, [driver-name] 

A list of all the files in the File Name Table is provided by 
entering LFIL. The first file listed is the current (active) file. 

Each file name is followed by the beginning address of the file, the 
ending address of the occupied area, and the end of the allocated area. 
The user can inspect the list of file names to determine if a proposed 
name is a duplicate. This command provides the user with a map of his 
files so that the user can decide on future memory allocation via file 
creates and moves. 
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Example : 


LFIL 

3100 3 IFF 

20FA 2FFF 
1000 1FFF 


TOMCAT 3100 
AIR 2000 
A 1000 


TOMCAT is the active file, but as yet it is empty. AIR contains 
FB bytes of information, and its allocated area is from 2J2f00 to 21FF. 
A, which was allotted lj3£Jj3 bytes of memory by the swath command S1000 , 
ends at 1FFF. 

Example : 


LFIL, CRT1 

* 


Files will be listed on CRT1 


Get Current File 

CURR, f ile-to-be-made-current 

Any file may be made current at any time the user is in the command 
mode. By checking the first line of output from the List File command 
LFIL, it can be determined which file is current. It usually is faster 
just to make the desired file current. An attempt to make a non-existent 
file current will give the message ERROR. After an error message, if 
it is felt that the syntax of the command was correct, then use LFIL 
to see if the file already exists. 

Example : 


CFIL. A, 1000, 
I XK>0 D217 

S100 

A 

i s 

the 

current file 

CFIL, B, 2000, 
DOGO D223 

SI 000 

B 

i s 

the 

current file 

CURR, A 


A 

i s 

now 

the current file 


Delete File 

DFIL , file-name 

Any file may be deleted by the DFIL command. Files are deleted 
one at a time. After a DFIL command is issued for the active file, 
there is no active file. Deletion of a non-existent file gives the 
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message ERROR. Execution of the Delete File command is followed by the 
system RAM boundaries. 

Example : 

Assume the files A, AIR, and TOMCAT exist, and that TOMCAT is the 
current file. 


DF IL, AIR 
DOOO D203 
DF IL. TOMCAT 
DOOO D1F7 
10 SSS 

NO CURRENT FILE 
CURR. A 
10 SSS 

DF IL. A. AIR, TOMCAT 
DOOO D1EB 


system ram boundaries 
current file is deleted 

can not enter text because 
no file is current 


only A is deleted 


Validate File 

VFIL 

The validate command performs the following operations: 

1) It checks that all lines within a file have a length; 

2) It verifies that each line ends with a carriage return; 

3) It checks the beginning of each line for a 4 digit line 

number followed by a space; 

4) It certifies that no control characters are part of the 

text . 

When a file passes validation, the name of the file is returned 
with its starting address, ending address of textual material within 
the file, and end of the region allocated for the file. If the file 
contains errors, the byte location of each error is given followed by 
the message FILE ERROR. It is assumed that typically the user only 
wishes to validate a current file; therefore, the VFIL is not followed 
by an operand, a file name. 

Example : 


VF 11- 

A1R 2000 2072 2FFF File AIR is ok. 


Assume at location 2001 the current file contains an error 
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VI-II 

2001 

f- ILF ERROR 


Move File 

MFIL , file-name, beginning-address-of-receiving-area 

An existing file may be moved to any existing memory location 
providing the space is not occupied by another file or system informa- 
tion. Attempts to move a file into another file's area will be greeted 
by MEMORY ALREADY ALLOCATED. After a move, the file will no longer 
exist at its previous location. The file to be moved need not be active. 

Example : 

Mf-IL, TOMCAT, 0 


CFIL, STAT, 2000, 300 
1)000 D203 
MM L, TOMCAT, 2000 
MEMORY ALREADY ALLOCATED 


Using File Commands 


A short demonstration using file commands only follows. 


The absence of an error message 
following the move indicates a 
successful move. 


Cannot move TOMCAT into area 
that is occupied by STAT. 


CMLf A, 1000, SI 000 
DOOO D1F7 
t ML 

A 1000 1000 1FFF 

D 2000 200A 2FFF 

OF 1L, A 

DOOO D1EB 

CHI.I A, 1000, S1000 

DOOO D1F7 

CF IL, B, 1000, SI 000 

DUD . NAMES 

l ML 

A 1000 1000 1FFF 

D 2000 200A 2FFF 

CURR, A 
DMT, A 


System ram boundaries 
File is empty. 

system ram decreased by 12 bytes 
B was already defined. 

Make A the current file. 
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DOOO D1EB 
J ABC 

NO CURRENT FILE 
CURR, B 

1 ABC Accepted because there is a current file 

CFIL, B. 3000, S200 

UUP. NAMES The file name mas already defined 

L.PIL 

B 2000 200A 2FFF 


CP IL, Tl, 3000, S200 
DOOO D1F7 
MPIl , B, 0 
MF IL, Tl, 1000 
LF IL 

11 1000 1000 

B 0000 OOOA 


B and Tl are nou> contiguous at low memory 

1 IFF 
OFFF 
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Section 2 

TEXT EDITING COMMANDS 


After creation of a file, the text commands allow the user to 
manipulate the contents of the file. In addition to adding or deleting 
the lines of a file, each line can be automatically numbered as it enters. 
Text lines can also be renumbered. Whether a listing will be formatted 
or unformatted is controlled by a flag in the monitor using the FORM and 
NFOR commands. To understand the effect of formatting using tabs see 
the section on the LIST command. Examples of assembly language will be 
presented in this section. For assembly language conventions see the 
section on assembly language. 


List 


LIST, [beginning-line-number], [ending-line-number], [driver-name] 

In the absence of parameters the entire contents of the active file 
are listed when the LIST command is used. If the formatting flag is set, 
then the list is formatted according to tab settings for the I/O driver. 
The section on I/O commands covers the setting of the tabs. When tabbing 
is used in the example below, assume the conventions given below. 

Example : 

FIELD TYPE LABEL OPERATOR OPERANDS COMMENTS 

COLUMN - 1 9 15 25 

CONTENTS - START: LD HL/ START ; LOAD HL 


When LIST is followed by one line number only, the indicated line 
is listed. If two parameters - line numbers - follow LIST, all the text 
lines from the first line number to the second line are listed. 

Example : 


CORK, B 
1 SSS 
LI SI 

0001 SSS Notice* left zero fill is automatic 
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CURR. AIR 
1XYI80 
LIST 

OOOi XYZ80 

CURR, B 
10 LD A. B 

20 START: LD HL, START 
30 JP START} JUMP TO START 

LIST Assume no fromatting 

OOOI SSS 
OOIO LD A/B 

0020 START: LD HL, START 
0030 JP START} JUMP TO START 

FORM Turn on the formatting switch 

LIST 

0001 SSS 

OOIO LD A, B 

0020 START: LD HL. START 

0030 JP START } JUMP TO START 

LIST# 10 

0010 LD A, B 

LIST, 10, 10 

0010 LD A, B 

LIST# 1, 20 

OOOI SSS 

0010 LD A, B 

0020 START: LD HL, START 


List Without Numbers 

TEXT, [beginning-line-number], [ending-line-number], [driver-name] 
TEXT only differs from LIST in that line numbers are not printed. 
Example : 


TEXT, 1,20 Assume no formatting 

SSS 

LD A, B 

START :LD HL, START 


The presence of a non-numeric character 
Signals the end of a line number 
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FORM Turn on the formatting switch 

TEXT, 20, 30 

START: LD HL, START 

JP START ; JUMP TO START 


Format Switch On 

FORM 

The FORM command turns on the format switch. This switch activates 
the tabbing associated with each I/O driver. The FORM command affects 
the LIST and TEXT commands and all assembler commands such as ASMB. The 
tabs can be changed by using the IODR command. Other selected I/O 
commands affect the tabbing by resetting tabs, e.g. SYSI. The FORM 
command is regional, that is it remains in effect until the occurrence 
of NFOR command. Further discussions of tabbing are covered under Assembly 
Language commands and the LIST command. 


Format Switch OFF 
NFOR 

The NFOR command deactivates the use of tabbing. 
Examples of FORM and NFOR: 


FORM 

l 1ST, 40, 60 

0040 BRNCH1 : CALL START 

0050 BRNCH2: JP START 

0060 LD A, B ; Z-SO 

NFOR 

LIST 

0040 BRNCH1 : CALL START 
0050 BRNCH2: JP START 
0060 LD A, B; Z-80 


Type Numbers Automatically 


AUTO, [lowest-line-number], [increment], [maximum-line-number] 
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The AUTO command is provided to relieve the user of having to enter 
line numbers. Four digit line numbers are automatically entered on the 
left margin by the AUTO command. The user specifies the starting number, 
the increment size, and the maximum line number. Any numeric value can 
be entered for any of three parameters. The default parameters are one 
for the starting number, one for the increment parameters, and 9999 for 
maximum line number. If the start number exceeds the maximum line, only 
one line will be printed and wrap around will not occur. 

Example : 


AUTO, 3, 7, 20 
0003 LD A, B 

0010 START: LD HL, START 
0017 JP START 
AUTO MODE COMPLETE 


The line numbers 0003, 0010, 0017 followed by a blank are printed 
by the monitor; the user then enters the text. 

Example; 


AUTO, 40, 10, 60 
0040 CALL START 
0050 JP START 
0060 LD A, B 
AUTO MODE COMPLETE 


Line number 60 was the limit given in the AUTO command so the monitor 
message indicated completion. If you wish to leave the auto mode before 
completion, press the ESC or ALT MODE key. 


Renumber File 

RENU, [starting-line-number] , [increment-size] 

Line numbers in the current file are renumbered by the RENU command. 
The user specifies the starting number and the increment size. The 
starting number is a line number from 1 to 9999, and the increment size 
ranges from 1 to 25. When the renumbering reaches 9000, the increment 
size is 1. Wrap around can occur when the line number reaches 9999; 
the next line numbers then will be 0, 1, 2, etc. It is possible to have 
two lines with the same number. Omission of either starting-line-number 
or increment-size or both causes a default to 1. 
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Example : 


t un 

0006 LD A, B 
0023 JP AGAIN 
0043 CALL SUB X 

RL- NUMBER, 20, 15 

t irn 

0020 LD A, B 
0035 JP AGAIN 
0050 CALL SUB X 


Delete Lines 


DELE, beginning-line-number, ending-line-number 

With the DELE command all lines are deleted from the first line 
number to the second line number, inclusively. 

Example : 


DEI ErTL. 35, 75 THE LINES FROM 35 TO 95 INCLUSIVE 

WILL BE DELETED 

DELE/ 20 LINE NUMBER 20 WILL BE DELETED 


DLL E , 20, 15 


NO LINE WILL BE DELETED 
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Section 3 

I/O - INPUT/OUTPUT COMMANDS 


The majority of commands in this section are related to routines 
called drivers. These routines contain instructions that allow data 
to be transferred in or out of the computer memory. The user is able 
to change selected parameters relating to drivers. The input and out- 
put addresses can be modified. The display of text through tabs and 
page size is alterable by the user. 

Three types of data representation are provided for, namely 1) 
an unmodified binary representation of memory contents, 2) INTEL 
hexadecimal, and 3) INTEL binary. In many of the examples given below 
reference is made to the I/O Driver Table and its parameters. These 
parameters are covered in some detail under LIOD - List I/O Drivers. 


List I/O Drivers 

LIOD, [driver-name] 

A table of I/O assignments is kept in the system RAM area, some- 
times referred to as the I/O Driver Table. An entry of LIOD will 
produce a listing of the table of I/O assignments. The example below 
explains each parameter. 

LIOD 


SYS000 

6F36 

6F3F 

0 

60 

6 

9 

15 

25 

(1) 

(2) 

(3) 

(4) 

(5) 

(6) 

(7) 

(8) 

(9 


(1) Driver name; in the example SYS000 is the system driver. 

(2) Input driver address. 

(3) Output driver address. 

(4) Number of nulls between each line. This allows time if 
needed for a line feed to take place before printing the next 
character on a hard copy device, e.g. teletype. 

(5) Number of lines per page - used for assembler paging. 

(6) Number of lines between pages - used for assembler paging. 

If this number is 0, a form feed is issued to advance to the top 
of the next page; otherwise, this is the number of line feeds 
that are issued to advance to the top of the next page. 

(7) Beginning column number of operation instruction, pseudo-op, 
etc. See explanation under LIST command. 
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(8) Beginning column number of operand. 

(9) Beginning column number of comment. 

Further examples of LIOD are shown under IODR and SYSI commands. 


Define I/O Drivers 


IODR, see LIOD for complete description of parameters 

Drivers may be either added or modified by the IODR command. Driver 
names may be from one to six alphanumeric characters. Omitted parameters 
are indicated by two adjacent commas or terminating the driver defini- 
tion before all parameter positions are indicated. Immediately follow- 
ing the I/O driver assignment the boundaries of the system RAM are 
given; this occurs because the assignment of a new driver will expand 
the system RAM area. 

Example : 


L 3 UD 

SYSOOO AF38 AF41 0 60 6 9 1 5 25 

IODR, DISK I, 8F00 
DOOO D22B 


A nev; driver DISKI is defined in the example above. The input 
driver address is 8F00. The absence of parameters between the commas 
indicates defaulting to the system output driver address of AF41. The 
number of nulls after a line feed is five. All the remaining parameters 
will be that of the system. To verify the assignment the I/O assignments 
are listed below. 

Example : 


L 101) 
SYSGOO 
DISK I 
I DDR, 1 TY 
DOOO D23B 
t I UD 
SYSOOO 
DISK I 
TTY 


AF38 AF 4 1 
8F00 AF4 1 


AF38 AF41 
8F00 AF41 
AF38 AF4 1 


0 60 6 9 15 25 

0 60 6 9 15 25 

Assign I/O driver TTY, default all 
parameters to system — SYSOOO. 

0 60 6 9 15 25 

0 60 6 9 15 25 

0 60 6 9 15 25 
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Delete I/O Driver Name 
DIOD, driver name 

The DIOD command deletes one driver from the I/O driver table each 
time it is used. SYS000 cannot be deleted. The system RAM boundaries 
are given after each successful deletion. 

Change SYSIO to Name 


SYSI , [driver name] 


The system I/O driver - the console device whose logical name is 
SYS000 - will have its parameters changed to the I/O driver name follow- 
ing the command SYSI. An entry of only SYSI returns the system I/O 
driver to the parameters stored in the PROM. The examples given below 
are a continuation of the results in previous section on Define I/O 
Drivers . 

Example : 


SYSI. TTY 





SYSOOO will have the same parameters as TTY 

IGOR, TTY, 

...» 0 




Change number of lines between pages from 






6 to 0 for TTY. In affect delete the line 






feeds and 

substitute a form feed. 

LIOD 







SYSOOO 

AF38 

AF41 

O 

60 

6 9 

15 25 

DISKI 

QFOO 

AF41 

O 

60 

6 9 

15 25 

TTY 

AF38 

AF41 

0 

60 

0 9 

15 25 






Note difference between SYSOOO and TTY. 

SYSI. TTY 







LIOD 







SYSOOO 

AF38 

AF41 

0 

60 

0 9 

1 5 25 

DISKI 

8F00 

AF41 

0 

60 

6 9 

15 25 

TTY 

AF38 

AF41 

0 

60 

0 9 

15 25 






There is 

now no difference. 

SYSI 





Reset SYSOOO to parameters in the prom. 

LIOD 







SYSOOO 

AF38 

AF41 

0 

60 

6 9 

15 25 

DISKI 

8F00 

AF41 

0 

60 

6 9 

15 25 

TTY 

AF38 

AF41 

0 

60 

0 9 

15 25 


Write Leader 


LEAD, [driver-name] 



2 ? 


Following the issuing of the LEAD command, there is a five or ten 
second wait, which allows time to turn on the punch; then 60 characters 
of leader are punched. The wait is five seconds at four magahertz and 
ten seconds at two megahertz. After punching the leader, control 
transfers immediately to the system. The user is advised to turn off 
the punch unit to avoid punching unwanted characters, such as control 
instructions, on the tape. 

Read and Write Commands 

In reading a tape the operator places the first character to be 
read directly over the read sprocket. At the conclusion of all reads 
the teletype may generate extra characters. These characters can be 
prevented from becoming a part of a memory file by pressing control X 
of the teletype. 

A five or ten second wait occurs after entry of any write command. 
This allows the operator time to turn on the punch. The wait is five 
seconds at four megahertz and ten seconds at two megahertz. 


Tape Formats 

There are three tape formats: 1) binary without a checksum, 2) 

binary with a checksum, and 3) hexadecimal. One frame on a binary tape 
represents one byte from memory; thus, a frame contains two hexadecimal 
characters. The contents of a binary tape can be read directly into 
memory and used without conversion. A hexadecimal tape uses two frames 
per byte of memory. The hexadecimal tape is in ASCII format and can be 
interpreted off-line by a hard copy device. The contents of this tape 
cannot be used by a computer without conversion to hexadecimal. 

The data on a hexadecimal tape is blocked into discrete records, 
each record containing record length, record type, memory address, and 
checksum information in addition to data. A frame-by-frame description 
is as follows: 

Frame 0 Record Mark: Signals the start of 

a record. The ASCII character colon 
(":" HEX 3A) is used as the record 
mark . 

Record Length: Two ASCII characters 

representing a hexadecimal number in 
the range of 0 to ' FF 1 (0 to 255). 

This is the count of actual data 
bytes in the record type or check- 
sum. A record length of 0 indicates 
end of file. 

Frames 3 to 6 Load Address: Four ASCII characters 

that represent the initial memory 
location where the data following 


Frames 1, 2 
(0-9, A-F) 
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will be loaded. The fir 1 
byte is stored in or 'hx- ; 

pointed to by the i s a :■ 
succeeding c i a t a b f • • s a r 
into ascending addresser. 

Record Type: Two A a 11 T 

Currently, a 1 1 r e e ; >r d s a i ■ 1 

This field is reserved for 
expansion . 


Frames 9 to 9+2* 

( R e c o r d Length) - 1 


Frames 9+2* (Record 
Len g t. h ) to 9 + 2 * (Record 

Length) +1 


Data: Each 8 bit memory word is 

represented by two frames containing 
the ASCII characters (0 to g, A to 
F) to represent a hexadecimal value 
0 to ’ FF ’ H (0 to 255). 

Checksum: The checksum is the 

negative of the sum of all 8 bit 
bytes in the record since the record 
mark evaluated modulus 2 5 0 . 

That is, if you add together all 
the 8 bit bytes, ignoring all carrie 
out of an 8-bit sum, then odd the 
checksum, t h o r e s u 1 1 i s z a r c . 


For example , 
the format of the 


if memory locations one through three contain 53: 
hex file produced when these locations are nun cm 


; 0300010053 F8ECC5 


A C ROMEMCO binary tape with checksum 
tape described above except, as mentioned, 
m e m o r y b y t e , 

The following read-write commands are 


is the same 
each frame 


grouped as 



fol 1 oc s ; 


WBCN ! Binary Format 
REIN ! without checksum 


Intel Hexadecimal 


WCBN | 
2 CBN 
RCBN ) 


Bina: 

with 



\a l 


Write Binary Tape 

W B I N , starti n g- a d d ress- i n - me mo r v , 


j end ing-memorv-addr c c o i 
i S lenoth ! 



mcific number of bytes starting at a given re mo re 
on rare by the W3IM command . Each frame on "he t an 
ed image of each byte from memory. 
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Example : 


WBINi 1000, S20 


Write 20H bytes from memory 
starting at location 1000H. 


Read Binary Tape 

, , ( ending-memory-address) [driver- 

RBIN, startmg-address-in-memory , ] g length ' name] 

A tape written by the WBIN command is read by the Read Binary Tape 
command. The contents of each frame will be read directly into memory 
without modification. 

Example : 


RB IN, 2000, 204F 


Read in 50H bytes starting at 
memory location 204F. 


Write Checksummed Binary Tape 


WCBN , 


star ting- address -in-memory , 


f ending-memory-address 
I S length 


[driver- 

name] 


The WCBN command allows the user to place a checksum at the end of 
a binary tape. The checksum is generated by summing up all the frames 
after the record mark. 


Write EOF on Checksummed Binary Tape 
ECBN , [driver-name] 

After the WCBN command, an end-of-file is written by ECBN. The 
message will be typed. A binary end-of-file cannot be interpreted 

for hard copy. 


Read Checksummed Binary Tape 


RCBN , 


starting-address- in-memory , 


( ending-memorv-address 
| S length 


[dri ver- 
name] 


The RCBN command allows the user to validate the contents of a 
binary tape. A tape is validated by summing all the frames after the 
record mark; carries are ignored. This sum is compared to the checksum 
written previously at the end of the tape. If the two sums do not match, 
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Write Checksum Hex Tape 

WCHX, startinq-address-in-memory, /endinq-memory-addresst [driver- 

IS length j ' name] 

The WCHX command will write an Intel hexadecimal tape with a check- 
sum. The checksum is generated by summing up all the frames after the 
record mark. The sum ignores carries and is written as the last frame 
in the record. 

Example : 


WCHX, 1000, S20 

Thirty-two bytes <20H) starting at location 10QOH are written onto 
a tape. The contents are reformatted into Intel hex code. 


Write EOF on Checksummed Hex Tape 
ECHX, [driver-name] 

After the execution of the WCHX command, an end-of-file is written 
by ECHX. The message ":00" (which is an end-of-file command in hex) will 
be typed. 

Example : 


FCHX 
: 00 


Read Checksummed Hex Tape 

T ,„ ... j, . (endinq-memory-address ) fdriver- 

RCHX , starting-address-m-memory , length )' name] 

The RCHX command allows the user to validate the contents of an 
Intel Hexadecimal tape. A tape is validated by summing all the frames 
after the record mark; carries are ignored. This sum is compared to the 
checksum written previously at the end of the tape. If the two sums do 
not match, the message "CS" is printed on the system I/O device. 
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Section 4 

MEMORY ACCESS COMMANDS 


Commands which enter, move, delete, or report on the contents of 
memory without regard to files or lines are classified as memory access 
commands . 


Dump Memory 


DUMP, beginning-memory-address, 


('ending-memory -address) [driver- 

) S length )' name] 


The result of a dump is listed in hexadecimal byte by byte. Each 
printed line contains a maximum of 16 bytes and is preceded by the 
memory address of the first byte. The two allowable command formats are 
demonstrated in the example below. 


Example : 


DUMP, 0, S10 Dump 16 bytes of memory starting at 

location 0. 

OOOO : 02 00 01 AB FE C3 F8 FE 00 7B FE 5F 54 41 32 54 


DUMP, 0, ID Dump 1DH bytes of memory 

0000: 02 00 01 AB FE C3 F8 FE 00 7B FE 5F 54 41 32 54 
0010: 20 00 00 80 44 52 4? 56 45 52 3F 6F 80 00 


Enter Memory 

ENTE, beginning-memory-address, [driver-name] 

The Enter Memory command allows the user to enter hexadecimal data 
starting at any memory location. A carriage control does not terminate 
the Enter Memory mode; thus, the user can continue to enter data line 
after line. The entry of a one to four digit number followed by colon 
will enter a new memory starting address. An attempt to enter an 
illegal byte will be reported as an ERROR after a line feed. All bytes 
up to the incorrect byte will be accepted. When using this command end the 
data input with a "/". 
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Single digit entries are filled with a zero on the left side while 
an entry of more than two digits results in having the two rightmost 
digits accepted. 

Example : 

ENTE/ 0 Start entering data at address zero 

12 2 1415/ 

DUMP, 0, 3 

OOOO: 12 02 15 The 2 has had a left zero added, and 

15 was entered in the third byte. 


ENTE, O 
12 2 1415 
23 44 

6 3000: 17 20 17 and 20 will be entered in 3000 and 3001 

/ 

ENTE, 1000 

12 23 24 55 1G 23 44 55 

ERR OR 1G is an illegal entry 

DUMP, 1000, S8 

lOOO: 12 23 24 55 00 00 00 00 

55 was the last legal byte 


Move Memory 


MOVE, beginning-sending-address. 


ending-address I beginning- 
S length of move ) ' receiving- 

address 


The MOVE command moves a byte at a time. If either the sending or 
receiving field exceeds the highest memory location, wrap around will 
occur to memory location zero. Any character may be propagated through 
a section of memory having the receiving address one greater than the 
address location. After a move, the VMEM command is called automatically 

Examples : 


MOVE , O, S200, 1000 

ENTE. O 
30/ 

MOVE. O, 6, 1 


Move 200H bytes from location 0 to location lOOOh 
Enter 30H at location 0. 

Propragate contents of location O for 6 bytes 
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DUMP, 0, 8 

OOOO: 30 30 30 30 30 30 30 F8 FE 


Verify Memory 

VMEM, beginning-sending-address , 


(ending-address) beginning- 
) S length j' receiving- 

address 


The VMEM command matches the contents of a series of locations on 
a byte by byte basis. Whenever a mismatch occurs, the first location 
is given followed by its contents; followed by the contents of the 
second location followed by its address. At the conclusion of a MOVE 
the VMEM command is invoked automatically. 

Example ; 


MOVE, 0, SI 000, 1000 
VMEM, 0, S1000, 1000 

Change value of 2 bytes, now areas should not verify 
Error in validation. 


ENT E, 444 
P3 40/ 

VMEM, 0, S1000, 1000 

0444 ?3 FF 1444 

0445 45 E5 1445 


Print System RAM Area 
PRAM 

The bounds of the system RAM area are printed the PRAM command. 
Example : 


PHAM 

1)000 D23B 


Select Bank (s) 


BANK, value 
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One or more banks on Cromemco memory boards can be selected with 
the BANK command. (When ROS is initialized, bank 0 is selected). Bank 
selection can be altered either with the BANK command or by outputting 
a byte to port 40]_6. A particular bank n is selected by entering a byte 
with bit n high as shown in the table below. 

BANK Output byte or value 


0 

1 

2 

3 

4 

5 

6 
7 


01 

02 

04 

08 

10 

20 

40 

80 


More than one bank may be selected at the same time by adding the 
values for the banks. 


Example : 


BANK, 80 
BANK, 88 


Bank 7 is now on, all others are off 
Banks 3 and 7 are on 
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Section 5 
CUSTOM COMMANDS 


Customizing allows the user to use his own set of mnemonic names. 
Those names may be one to four characters long. The user can equate 
any allowable name to a memory location. This name, when entered, 
becomes a command to begin execution at the designated memory location. 
Either a user routine or a system routine can be evoked. Customizing 
also allows the user to add his own name to call a monitor command. 

The list of custom names is dynamic and may be added to or contracted 
at any time. 


Enter Custom Name 

ECUS, custom-name, memory-address = transfer address 

ECUS and RENA are the two commands that add custom names. ECUS is 
used to equate a one to four character custom name to a memory location. 
Whenever a successful entry is made, the system responds with the new 
system RAM boundaries. 

Example : 


ECUS. QUIT, AOOC 
DQOO D241 
QUIT 

ECUS, PROCES, 1000 
DOOO 1)247 

PROCESS 


AOOC is the reenter address. 

When QUIT is nou/ typed in, ROS now transfer* to AOOC. 

The user has a process control program starting at 
location 1000H. 

The process control program is entered at 1000. 


List Custom Name Table 

LCUS, [driver-name] 

The LCUS command will list the names in the custom command table. 
Each name is followed by the transfer address associated with the 
For examples of LCUS see the section on DCUS. 


name . 



36 


Delete Custom Name 

DCUS, custom-name 

The DCUS command deletes one custom name from the custom table each 
time it is used. The system RAM boundaries are given each successful 

deletion . 

Example : 


LCUS 

QUIT AOOC PROC 1000 
DCUS. PROCES 
DOOO D241 
LCUS 

QUIT AOOC 
ECUS. AP, 1500 
DOOO D247 
ECUS. HATHX, 2000 
DOOO D24D 
DCUS, SUM 

ERROR SUM ua s not in the table. 


Rename System Command 

RENA, system-command, custom-name 

A duplicate custom name for a system command is obtained by using 
the RENA command. The RENA command is particularly useful when used 
to shorten the name of a frequently evoked routine. 

Example : 


RENAH, DUMP, D 
DOOO D253 
D, 1, S2 


OOOl : 30 55 

RENAM, DUMP, # 
DOOO D259 
#, 3, S2 


Two names now exist for DUMP 
D now produces a dump. 


Special characters are excepted. 

There are now three command that will dump 
memory - DUMP, D, and #. 


0003: 45 98 
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Section 6 

ASSEMBLER COMMANDS 


Assembler system commands enable the user to allocate memory for 
the symbol table and to control assembly options. An assembly with 
options allows the user to define the location of his source code and 
the destination of his object code. 

Three assembly options ASMB, ASMO, and ASMU have the same format. 

The format is: Command, Parameter 1, Parameter 2, Parameter 3. While 

Parameter 1 is the origin address of the assembly, Parameter 2 is the 
actual memory location for the assembled code, and Parameter 3 is an 
assembly option indicated by a digit 1 to 4 . 

The options available under Parameter 3 are indicated by the follow- 
ing numbers. Option 1 gives a complete assembled listing. Option 2 
will list errors only. Option 3 will print a symbol table after the 
listing. Option 4 provides a cross reference table in addition to 
assembly listing. The commands FORM and NFOR are used in conjunction 
with the formatting of an assembled listing. 


Print Symbo l T able Allocatio n 
PSTA 

The PSTA command lists the beginning and end of the symbol table. 
At the beginning of a program the symbol table is initialized to start 
at the end of the system RAM. The upper boundary is at address DFFF . 
Examples of PSTA are given under the STAB command. 


Define Symbol Table Location 


STAB 

The STAB command can reallocate the symbol table in any memory area 
not occupied by a file. The first parameter following the command is 
the new beginning address of the symbol table. If the first parameter 
is omitted, the beginning address will default to the next memory loca- 
tion after the system RAM. The second parameter must always be given 
and is either the amount of memory allocated or the upper address. 


Example : 
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PR AM 

I>000 D1EB 
PS 1 A 

D1 EC DFFF 
STAB. 0, 4FFF 

MEMORY ALREADY ALLOCATED 

STAB, O, S1000 

0000 OFFF 

STAB, . DFFF 

D1EC DFFF 


Print system ram boundaries. 
Print symbol table boundries. 


This area available for symbol 
Default of first parameter is 
end of system ram. 


tab le. 
end 


Assemble 

ASMB, assembly-origin-addr , addr-assembly-code , assembly-option 

The ASMB command assembles without user interaction with respect 
to the source or object allocation. However, the user does have the 
option of choosing four types of assembly listing. These options are 
described in the beginning of this section. 

Example : 


ASMB, 1000. 4000, 1 Complete assembler listing. 

C-ROMEMCO Z-80 ASSEMBLER V. 2. 0 


lOOO 

78 



iooi 

81 



1002 

C3 

05 

10 

1005 

CD 

02 

10 

1008 

21 

06 

00 

lOOB 

21 

06 

00 


OOIO 


LD 

A, B 

0020 


ADD 

C 

0030 

LABI : 

JP 

LAB3 

0040 

LAB3 : 

CALL 

LABI 

0050 


LD 

HL, 6 

0060 


LD 

HL, 6H 


ASMB, J 000, 4000, 2 List errors only 

CRt.JMF.MC 0 z-80 ASSEMBLER V. 2. 0 


ASMB, 1000, 4000, 3 

OROMFMCO Z-80 ASSEMBLER V. 2. 0 


Assembler listing and symbol table 
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1000 

78 


0010 


LD 

A, B 

lOOl 

81 


0020 


ADD 

C • 

1 002 

C3 

05 10 

0030 

LABI : 

JP 

LAB3 

1005 

CD 

02 10 

0040 

LAB3: 

CALL 

LABI 

looe 

21 

06 00 

0050 


LD 

HL, 6 

1 00B 

21 

06 00 

0060 


LD 

HLi 6H 

SYMBOL 

TABLE 





l AB 1 


1002 LAB3 

1005 





ASMB, 

1000 

, 4000, 4 

Assemb ler 

listing 

CROMFMCO 

Z-80 ASSEMBLER 

V. 2. 0 



1000 

78 



00 10 

LD 

A, B 

1001 

81 



0020 

ADD 

C 

1002 

C3 

05 

10 

0030 LABI. 

JP 

LAB3 

1005 

CD 

02 

10 

0040 LAB2: 

CALL 

LABI 

1008 

21 

06 

00 

0050 

LD 

HL, 6 

lOOB 

21 

06 

00 

0060 

LD 

HL, 6H 


and 


crossreference 


CROSS REFERENCE 


LABI 1002 0040 

L ABO 1005 0030 


Assemble with Options 

ASMO, assembly-origin-addr , addr-assembly-code , assembly-option 


The ASMO command allows the user to specify devices (drivers) for 
the assembly listing, the assembly source code, and the output driver. 
The user also specifies the form of the output to a device. The chart 
on the next page indicates the choices available to the user. The 
defaults for several options are given below. 

Option Def aul t 


LIST= 

READ= 

PUNCH= 


SYS 000 
SYS000 

The driver specified 
by LIST. 
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An attempt to enter an undefined driver will result in the question 
being repeated. When an output tape is requested by PTYPE, the assembly 
listing is first listed on the LIST device followed by the punching of 
the tape . 

Example : 


ASHQ, 4000. 1000, 1 
LIST -TTH 
LIST TY 
RTYPE- I 
READ = DISKI 
PTYPE=N 

ASMO, 1000, 4000, 1 
LIST -TTY 
RT YPE=M 
PTYPE=H 
PUNCH^TTY 


TTH has not been defined as a driver 
TTY will be the driver for the listing 
Source will be read from I/O 
DISKI will be the source driver 
Object code will not be generated 


Source code is in memory 

Produce Intel hex tape 

Punch output tape using driver TTY 


Assemble Unnumbered I/O File 

ASMU, assembly-or igin-addr , addr- assembly-code , assembly-option 

The ASMU command is identical to the ASMO command except that it 
will list unnumbered I/O files. Only I/O files may be unnumbered. When 
an unnumbered file is listed, numbers are placed at the beginning of 
each line. Numbered files are listed without modification by ASMU. 
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Section 7 


MISCELLANEOUS COMMANDS 


Execute at Given Address 

EXEC, address 

The EXEC command transfers CPU control to the given address by 
executing an unconditional CALL instruction. A simple return to ROS , 
the resident operating system, may be made if the user at the end of 
his subroutine insures 1) that the address popped onto the stack by 
the CALL is pointed to by the stack pointer, and 2) that the last 
instruction executed in the subroutine is a return, RET. Performance 
of the above steps allows execution of the next instruction in the 
main program. 


Burn PROM 

PROM, starting-address, j ^length 633 } destination address 

A 2708 is burned by the PROM command using the Cromemco Bytesaver 
card. The starting address does not have to begin on a IK boundary. 

The resident operating system, ROS, will burn FF]_6 into unused areas. 
The unused areas are defined to be areas outside of the addressed areas 
but contained within a IK block. The FF^g and the new data are written 
to the selected PROM 360 times to insure good programming. 

To program a PROM, type the command PROM but do not depress the 
carriage return. Next, turn the program power switch on the Bytesaver 
to ON and then type carriage return. The front panel lights will 
count down. When the light pattern becomes stable, your PROM is pro- 
grammed. ROS now verifies that the PROM was correctly programmed. 
Incorrect programming is indicated by displaying the nonverifying 
addresses and their content in the same format as the VMEM command. 
Remember to turn the program power switch of the Bytesaver to OFF 
upon completion of the PROM command. 

Example : 


PROM. 1000, S40, 6040 


Burn 2708 prom 


DUMP, 6030, S60 



43 


6030: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
60-10 : 30 30 30 30 30 30 30 30 53 0D OD 30 30 31 30 20 
6050: 4C 44 20 41 2C 42 OD 18 30 30 32 30 20 53 54 41 
6060: 52 54 3A 4C 44 20 48 4C 2C 53 54 41 52 54 OD ID 
6070: 30 30 33 30 20 4A 50 20 53 54 41 52 54 3B 4 A 55 
6080: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 


This listing shows that after the PROM command has been executed 
the PROM memory IC does contain information from address 6okO to 
address 607F (since in the PROM command it was specified to 
program a swath just iO bytes wide). The rest of the PROM has 
not been programmed at all and thus reads "FF" in each address 
location, which is the unprogrammed state. 
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CHAPTER 3: CONVENTIONS AND PSEUDO-OPS 


Formats 

The most encompassing assembler format is shown below: 

Formal Label: Operation Operands ; Comment 

Actual COMP 2 5 : LD HL, VALUE I ; Initialize HL 

The label must be followed by a colon. The colon may be followed 
immediately by the operation or one or more blanks. Labels need not 
start in column one. 

The maximum accepted length of a label is six alphanumeric charac- 
ters. All labels must start with an alphabetic character. All labels 
in the label field must be followed by a colon. A label cannot be a 
register name. 

Correct Labels 

T12345 

Al 

T123456 Last character is ignored 
Incorrect Labels 


A 

E 

SP 

HL 

B 

F 

AF 

IX 

C 

H 

BC 

IY 

D 

L 

DE 

R 


I 


4 A5B Starts with a numeric character 

An op-code may be preceded by a label. A space is not required be- 
tween the label and the op-code. The op-code must be followed by at 
least one space. The operands must be separated by commas. The length 
is governed by the type of reference. A reference to a register pair 
is typically two characters. A label as an operand is up to six alpha- 
numeric characters, and a numeric literal may not exceed FFFF hexadecimal. 
The op-code of an unlabeled code line may start in column 1. 

Example : 


LABLE: LD HL, 14263; 14623 IS BASE TEN AND LESS THAN OFFFFH 
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L I) HL, 14263; OPCODE (OPERATION) STARTS IN COLUMN 1 
; NUMBER IS BASE TEN-DECIMAL 


All comments must start with a semi-colon. Comments need not be 
separated from the final operand by a space, although one or more spaces 
are permitted. 

Example : 


PRT 4 : OUT DATA, A; OUTPUT CONTENTS OF ACCUMULATOR 

PNT4: OUT DATA, A ; SAME EFFECT AS LINE ABOVE 


Data Representation 


Any number is used in assembler code defaults to decimal in the 
absence of a stated base. A number followed by an H is declared hexa- 
decimal . 

Example : 


LD A, OFFH 

LD A, 255 

LD HL, OFFFFH 


LOAD MAXIMUM PERMITTED VALUE - OFFH 
INTO THE ACCUMULATOR 
MAXIMUM PERMITTED VALUE IN DECIMAL 
MAXIMUM PERMITTED VALUE FOR A 
REGISTER PAIR 


If a two byte operand exceeds 65,535, then a value of modulus 65,536 
is returned without an error flag. Arithmetic expressions are allowed 
as operands. Computations are performed on both numbers and labels. 

The operations of addition, subtraction, multiplication, and division 
are allowed. The expression is evaluated from left to right. The 
expression 2+6*2 will evaluate to 16. 

Example : 


load b with 16 

If LOCI is twenty locations higher 
than L0C2 then A is loaded 
with 20. 


LD 

LD 


B, 2+6*2 
A, L0C1-L0C2 
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A references the address of the next instruction 

Load HL with address of SETBC 
Load BC with address of CQMP+15 

Assembler Listing Controls 
TITLE 

Label Code Operand 

optional: TITLE ASCII string 

An operand of up to 80 characters will appear as a header on all 
successive pages until the occurrence of another TITLE command. The 
ASCII string is not enclosed in quotes. The label field in this command 
has no effect. TITLE causes an immediate EJECT. 

Example : 

EJECT 

Label Code Operand 

optional: EJECT none 

The EJECT command, which advances the paper to the top of the next 
page, is used for clarity in an assembly listing. A routine can be 
identified more clearly if preceded by an EJECT. 


Data Structure 

DEFS - Define Storage 


Label 

Code 

Operands 

optional : 

DEFS 

expression 

optional : 

DS 

expression 


The define storage command reserves one or more bytes of storage. 

The numeric value of the operand determines the number of bytes reserved. 
Evaluation of the arithmetic expression is from right to left. 

Example : 


LD HL, * 

SETBC: LD BC,*+15 


Bl.OCKA: DEFS 
bLOCKI): DS 


20 

20H 


; RESERVES 20 BYTES 
; RESERVES 32 BYTES 
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DEFS 

LAB 1+2*4 

i IF 

LABI 

IS EQUAL TO 20 THEN 



; 88 

BYTES 

ARE RESERVED 

DEFS 

LAB4-LAB3 

; COMPUTE 

DIFFERENCE OF LAB4 AND LAB3 


Define Storage (BYTE) 

DEFB 


Label 

Code 

Operands 

optional : 

DEFB 

expression 

optional : 

DB 

expression 


The define byte allows either a numeric expression or an ASCII 
string to be generated. The numeric expression must be in the range 
plus or minus 256. However, an ASCII string enclosed in quotes is 
valid . 

Example : 


DB 

' ABCDEF 

DB 

'A '+3 

DEFB 

'ABC ' + 3 

DB 

'ABC ' 


ASCII string occupies 6 bytes 
The value 44H is generated 
Illegal* arithmetic result too large 
Several fields are allowed 


Define Storage (WORD) DEFW 

Label Code 

optional: DEFW 

optional: DW 


Operands 


expression 

expression 


The define word allows a numeric expression or an ASCII string 
to be defined. A numeric expression which exceeds 65,535 will be 
evaluated modulus 65,536; overflow will be ignored. The ASCII string, 
enclosed in quotes, is limited to one word (two characters). The entire 
line may be filled with operands. 


Example : 


DW LABI, LAB 2 Labels OK 

DW $ Current value of the location counter 


To clarify the action of the dollar sign, 


consider the code below: 


The value of the location counter 


ORG 

DB 


0 

* 


is zero 
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DB 

7, % 

The second byte has a 

value of 2 

DW 

'AA' 

Evaluates to 4141H 


DW 

'A ' 

Evaluates to 0041H 


DW 

9, 'BD ' . LAB4 

More than one express 

ion permitted 

DW 

'PDG ' 

1 1 legal, too long 



Assembly Directives 


Origin 



Label 

Code 

Operand 

optional : 

ORG 

arithmetic ex- 
pression 


The ORG instruction sets the assembler location counter. The 
counter may be set to a value more than once during assembly. 


Example : 



ORG 

ADD 

ORG 

100H 

A 

200H 

; LOCATION COUNTER IS SET AT 100H 
; THIS INSTRUCTION ASSEMBLED AT 100H 
; THE LOCATION COUNTER IS NOW 200H 

EQU 

- Equate 




Label 

Code 

Operand 


label : 

EQU 

expression 


The label field is equated to the operand. An EQU instruction must 
have a label. The operand, if a label, should be a previously defined 
label. Any arithmetic expression is allowed. The EQU is global; once 
a label is defined, it is defined for the entire program 

Example : 


; CORRECT IF LABI PREVIOUSLY DEFINED 
> ARITHMETIC EXPRESSION ALLOWED 


LAB?; EQU LABI 

LABLE: EQU 12*317+4 



Operand 


;ne assembly 


co no wav 


' a w a reacnavi t.m • • v j or a memory tiler an ena or: rile, 
tvs assembly, A. third way to end a program occurs with I/O files 
I/O driver is first called, the carry flag is set. The setting 
r:ry flag indicates a rewind of a file such as a disk file. When 
ver reaches the end of the file being processed, it returns a 
set the Z flag {zero flag) . When both the carry flag and the 
a g a r e set, a s s e mb 1 y will be terminated. 



CHAPTER 4: USEFUL SYSTEM SUBROUTINES 


Selected system subroutines can aid the user in his programming . 
A list of useful system subroutines with short descriptions are given 
below. Before using any of the routines, index register IX must be 
loaded with the address of BASE. This address is found under Linkage 
to Common Routines. 


RESTRT 

This routine will restart ROS. ROS will be initialized providing 
that it was not initialized previously. The command mode is entered. 
This routine does not RETURN. 


REENTR 

The system is reentered without restarting. This routine is used 
when the user routines are ended. It does not return to the caller. 


CALINT 

The resident operating system is initialized and a return is made 
to the caller. 


ACCES 


This routine allows program access to all system commands. The 
HL register points to an input table. Each entry in the table is a 
command string followed by a carriage return. A byte of zero ends the 
table. If there is an error, this routine will not return to the caller. 

The example below demonstrates a user routine containing two system 
commands, IODR and EXEC. 

Example : 


CROMEMCO Z-80 ASSEMBLER V. 2 . 0 

2000 21 07 20 0001 START: LD HL, TABLE 
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2003 

CD 

12 

AO 


0002 

CALL 

ACCES 

2006 

C9 




0003 

RET 


2007 





0004 ; 



2007 

49 

4F 

44 

52 

0005 TABLE: 

DB 

' IODR# DISKI, FCOO ' , 13 


2C 

44 

49 

53 





4B 

49 

2C 

46 





43 

30 

30 

OD 




2017 

45 

58 

45 

43 

0006 

DB 

'EXEC, A000 ' , 13 


2C 

41 

30 

30 





30 

OD 






2021 

00 




0007 

DB 

0 

2022 





0008 i 




AO 12 



0009 ACCES: 

EQU 

0A012H 


SYSOUT 

This routine is the system output routine. To output a character 
to the current system output device, load the B register with the 
character to be sent. Only the AF registers will be altered. This 
routine will not return if an ESCAPE is read from the input device. 


SYS IN 

This routine will get a character from the current system input 
device. The character will be returned in the A and B registers. Only 
the A, F, and B registers are altered. This routine does not return if 
an ESCAPE is read from the input device. 


P2HEX 

The contents of the HI. register are printed in hex on the system 
output device. Only AF and BC are altered. 


PlHEX 

The contents of the A register are printed in hex on the system 
output device. Only the AF and BC registers are altered. 


P2HEXS 

This routine calls P2HEX and then prints a space. 
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PlHEXS 

This routine calls P1HEX and then prints a space. 


PRTNUM 

This routine will output characters to the system output device. 
The HL registers are to be loaded with the address of the characters 
to be printed and the D register loaded with the number of characters 
to be printed. Only the AF, B, and D registers are altered. 


READLN 

This routine will read one line from the system input device using 
all editing features of ROS . The HL register will return pointing to 
the new line and BC registers will contain the length. 


GNAME 


This routine gets a six character name from the input line. This 
routine is used with custom commands to retrieve a name parameter from 
the input line. On input IY must point to the current position in the 
command line. This register has already been loaded when the custom 
command was executed. On output the Z flag will be set if there is a 
default, DE will point to the six character name padded with blanks, 
and IY will point to the new position in the line. 


SIOTAB 

This routine will search the I/O table. The name to be searched 
for is to be loaded into the DE registers before execution of SIOTAB. 
On return from the routine the Z flag will be set if found and the HL 
registers will point to the I/O parameters for the name found. 


GTHEXM 

This routine is used with the custom commands to retrieve a HEX 
VALUE parameter from the input line. Before calling the routine, IY 
must point to the current position in the line. This register has 
already been loaded when the custom command was executed. On return 
the Z flag is set if default has occurred. The HL register contains 
the HEX VALUE. This routine does not return on error. 


GTDECM 

This routine is the same as GTHEXM except the parameter in the 
custom command is decimal. 
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ERROR 


This routine prints the word ERROR on system output and then enters 
the command mode. This routine does not return. 


MS GOUT 

This routine is used to output a message to the system outDut device. 
The HL registers are to contain a pointer to the message. Characters are 
orinted until a carriage return is found. Only the AF , B, HL registers 
are altered. 


PRNTTB 

The table pointed to by the HL registers is to be printed on the 
system output device. The user may want to refer to the section on Table 
Format . 


COMPAR 

The HL registers are to be loaded with a pointer to the first argu- 
ment. The DE registers must point to the second argument. The length 
of the compare is placed in the B register. When the routine returns, 
the Z flag will be set if the two arguments were equal. If the first 
argument was greater than the second argument, the carry flag will be 
set . 


SEARCH 

This routine searches the table pointed to by the HL registers. The 
DE registers point to the name to be found in the table. On return, if 
the name is found, the Z flag is set and HL points past the name to its 
narameters. Otherwise, the Z flag is not set and the HL registers point 
past the last entry in the table. 


LOOK 


This routine has the same function as SEARCH excent that if the name 
being sought is found, then HL points to the entry in the table. 


FILL 


Execution of FILL fills each byte in a specified area of memory with 
the value in the A register. The number of bytes to be filled is given 
by the value in the BC registers and the starting address is contained 
in the DE registers. 
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CLEAR 


This routine will clear a specified area of memory by loading 
spaces into each byte. The number of bytes to be cleared is given by 
the BC registers. The starting address is contained in the DE register 
pair . 


MBLNK 

This routine will move the data starting at a location pointed to 
by the HL registers to the area pointed to by the DE registers for a 
length specified by BC or until a delimiter is encountered. The Z flag 
will be set if a delimiter stops the move. System routine CDILM lists 
the delimiters. 


SBLNK 


This routine increments the HL registers until they do not point 
to a space. 


SCHAR 


This routine increments the HL registers until a delimiter is en- 
countered. The delimiters are: 


+ - / * ) 


plus space and carriage return. 


CMBLNK 

This routine calls CLEAR and MBLNK. 


CNUM 


This routine checks the A register for a numeric character. The 
carry is set if not numeric. 


GETHEX 

A hexadecimal number is fetched from memory and entered into regis 
ters DE. The first byte of the number is pointed to by registers BC 
and the byte following the number is pointed to by registers HL. If 
an error occurs, e.g. a number that is not a valid hexadecimal number 
is encountered, the carry flag is set. 



55 


GDECM 


A decimal number is fetched from memory and entered into registers 
DE. The first byte of the number is pointed to by registers BC and 
the byte following the number is pointed to by registers HL. If an 
error occurs, e.g. a number that is not a valid decimal number is en- 
countered, the carry flag is set. 


LEADER 

Seventy nulls are written to the system output device after a five 
second wait. 


EINTEL 

In this routine an end of file is written for an INTEL format tape 
Carry prime, in the auxiliary flag register - F', must be set for hex 
tape. If carry prime is not set, then a binary end of file will be 
generated . 


CHKCUR 

This routine checks to see if a current input file is present. If 
no input file is present, the message: "NO CURRENT FILE" will be typed 

and control will be returned to ROS . Otherwise, the routine will re- 
turn to the user. 


WINTEL 

In this routine an Intel format taoe is written. On entry, regis- 
ter D contains the record length, HL contains the address, IY points to 
stored data, and carry prime is set if hex data is used and reset, 0, 
if binary data is used. 


PRTONE 

In this routine one line of data is printed using assembler tabs. 
On entry HL points to the line. If the carry bit is set, the text with 
out a line number is printed. When the carry bit is reset, 0 line 
numbers are printed with the text. 


GTSTNG 

In this routine a string of characters is obtained by calling 
CMBLNK. Refer to CLEAR and MBLNK for additional parameter information. 
HL is then incremented until pointing at a comma or carriage return. 
Also, the routine puts the contents of HL in IY. 
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INTTAB 

This routine initializes the routine GTENT. When entered, HL must 
point to the table. 


GTENT 

In this routine an entry is obtained from a table whose position 
is pointed to by HL. HL returns pointing to the next entry in the table 
The Z flag is set at the end of the table. 


FUPACK 

In this routine the four packed decimal digits in the DE registers 
are unpacked into the area pointed to by the HL registers. 


AFPACK 

The four decimal digits in the DE register are added to the four 
decimal digits in the HL registers. The result is left in HL and the 
carry is set if the result is greater than 9999. 


FPACK 


The four decimal digits pointed to by the HL registers are packed 
into the DE registers. 


CDILM 


This routine checks a specific byte to see if it is a delimiter. 
The delimiters are: 


+ - / 


) 


plus space and carriage return. HL is loaded with the pointer to the 
character to be tested. The Z flag will be set if the character is a 
delimiter . 


ADDAHL 

The A register is added to the HL registers. The result is left 
in the HL registers, and the carry flag will be set if overflow occurred 


SPACnn 

This set of routines will print nn spaces to the system outout 
device. Only the AF and B registers are changed. 
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CHAPTER 5: WRITING I/O ROUTINES 


The IODR command may be used to change I/O drivers. The input 
driver address and output driver address are the first and second 
parameters following the driver name (see List I/O Drivers). By 
changing the parameter addresses the user may reference his own 
I/O drivers. 


System Input Drivers 


A standard input driver routine first checks to see if a char~ 
acter is ready to read. If a character is not available, the A 
register is zeroed, the carry flag cleared, and the routine returns. 

If there is a character available, it will be read into the A register 
and the carry flag will be set. All registers except AF must be 
preserved. A return is now made to the system. The example below 
shows a system input driver. 


AF38 



0001 ; 





AF38 



0002 i STANDARD INPUT DRIVER 


At 38 



0003 i OUTPUT 

- CARRY SET 

IF 

CHARACTER 

AF38 



0004 ; 

A 

CONTAINS 

CHARACTER 

AF 38 



0005 ; 





AF38 

DB 

00 

0006 INPUT: 

IN 

Ar 0 


; GET STATUS 

AF3A 

E6 

40 

0007 

AND 

40H 


; CHECK FOR CHARACTER 

AF3C 

C8 


0008 

RET 

Z 


; NO CHARACTER 

AF3D 

DB 

01 

0007 

IN 

A, 1 


i INPUT CHARACTER 

AP3F 

37 


0010 

SCF 



; SAY GOT CHARACTER 

AF 40 

C7 


0011 

RET 





Assembler Input Drivers 


An assembly input driver differs from a system input driver in 
handling flags and in accepting input from an external device as de- 
scribed below. If on entry to the input driver the carry flag is 
found to be set, a rewind of the input file is to be executed. For 
example, if the input file is paper tape, the tape will be started 
over again. The input routine does not return until a character is 
received. The character is read into the A register, then the Z flag 
is cleared, and the routine returns. When an end of file is sensed, 
the Z flag is set before a return. All registers must be preserved. 
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In the input example below a carry flag is not used. When using 
the teletype, the operator knows where to start loading the tape; re- 
winding is not possible on a teletype, so a flag is superfluous. 

However, a set carry flag could have been used to display a message. 

On the other hand, if the file were a disk file, the carry flag could 
be used to rewind the file. In the example a contiol Z, 1A hexadecimal, 
is used to indicate the end of the file. If the END pseudo-op code is 
used in the source code, a control Z is not necessary. 

Example : 


CROHEMCO 

Z-80 

ASSEMBLER V. 2. 

0 




lOOO 



0001 

i 




lOOO 



0002 

i TELETYPE INPUT DRIVER FOR ASSEMBLER 

lOOO 



0003 

; INPUT 

- CARRY SET TO 

REWIND FILE 

lOOO 



0004 

i OUTPUT 

- A 

CONTAINS 

CHARACTER 

lOOO 



0005 

i 

Z 

FLAG SET 

IF END OF FILE 

lOOO 



0006 

i 




lOOO 

DB 

OO 

0007 

INTTY: 

IN 

A, 0 

; GET STATUS 

1002 

E6 

40 

0008 


AND 

40H 

; CHECK FOR CHARACTER 

1004 

28 

FA 

0009 


JR 

Z, INTTY 

; NOT READY 

1006 

DB 

01 

0010 


IN 

A, 1 

; GET CHARACTER 

.1008 

FE 

1A 

0011 


CP 

1 AH 

; CHECK FOR END OF FILE 

lOOA 

C9 


0012 


RET 




Output Drivers 

The output driver expects the character to be written to be in 
the B register. When the output driver returns, the A and B registers 
should both contain the output character. All other registers must be 
preserved. 

Example: 


AF41 



0001 

i 




AF41 



0002 

/STANDARD OUTPUT DRIVER 


AF41 



0003 

; INPUT • 

- B CONTAINS CHARACTER 

AF41 



0004 

/ OUTPUT 

- A 

AND B CONTAIN 

CHARACTER 

AF41 



0005 

» 




AF41 

DB 

00 

0006 

OUTPUT: 

IN 

A, 0 / 

GET STATUS 

AF43 

E6 

80 

0007 


AND 

80H / 

GET TBE 

AF45 

28 

FA 

0008 


JR 

Z, OUTPUT 

LOOP UNTIL READY 

AF4? 

78 

‘ * 

0009 


LD 

A, B ; 

GET CHARACTER 

AF48 

D3 

01 

0010 


OUT 

1, A ; 

OUTPUT CHARACTER 

AF4A 

C9 


OOll 


RET 





APPENDIX A 


Custom Commands with Parameters 

Custom-name, [Parameter -l] , [Parameter- 2] . . . Input line 

Before accessing the contents of the parameters listed above the 
user first equates his custom-name to the entry point of a routine. 

When the custom-name is executed, a call is made to the user routine, 
and register IY will point to the first parameter in the input line. 

The user may now call system subroutines (see Useful System Subroutines) . 
The system subroutines can perform tasks such a checking the existence 
of the parameters or retrieving the contents of a parameter. Before 
using any of the system subroutines, IX must point to BASE. The address 
of BASE is obtained from Linkage to Common Routines (list is given in 
Appendix G) . 
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APPENDIX B 

Using Parameters in the Command Line 


In the code shown below the user ultimately references a routine 
EXAM which will receive parameters from the command line. EXAM uses 
several system routines. The first routine attempts to find the loca- 
tion of the parameters pointed to by the IY register. If the parameter 
is not found, an error message routine is called. The third routine 
retrieves the contents of the parameter. In the sequence of events 
the user first loads, perhaps via paper tape, a routine PLOT into the 
starting memory address 1000H. Then the custom command PLOT is equated 
to the location 1000. 


ECUS, PLOT, 1000 

Eventually, the user executes the command PLOT 

PLOT, X, Y 

When PLOT is called, the IY register will point to the first para- 
meter, X. The routine PLOT contains two calls to EXAM. 


CALL 

EXAM 

i IY POINTS TO COMMAND LINE 

LD 

CALL 

< SAVEX ) / HL 
EXAM 

; SAVE VALUE FOR X 

LD 

(SAVEY), HL 

; SAVE VALUE FOR Y 

CALL 

RET 

DAZLER 

; PUT DOT ON DAZZLER 
> RETURN TO ROS 


The subroutine EXAM is given below. The circled numbers refer to 
commentary about each instruction. 


tX AM. 

CALL 

GNAME 

; GET 

NAME PARAMETER 

1 ) 


JR 

Z, ERROR 

; DID 

NOT FIND NAME 

2) 


CALL 

GTHEXM 

; GET 

HEX VALUE 

3) 
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JR 
LD 

EXM300. LD 
RET 

i 

SAVE 1 : DS 

GNAME: EGU 

ERROR. EGU 
GTHE.XM: EGU 

1) A call is made to the system routine GNAME. Before the 
call the user equates 9) GNAME to the address found under 
Linkage to Common Routines in appendix H. The GNAME sub- 
routine, as described under Useful System Subroutines, will 
attempt to find the address of the parameter pointed to by 
IY. If the search is successful, DE will contain the address 
of the parameter, and the IY pointer is advanced to the next 
parameter. An unsuccessful call is indicated by the Z flag. 

2) When the Z flag is set, a jump is performed to the system 
subroutine, ERROR. The ERROR subroutine prints or displays 
the message "ERROR" . 

3) If a parameter is a hexadecimal value, the GTHEXM will 
place this value in the HL register. Failure to return the 
value is indicated by setting the Z flag. 

4) Jump to EXM300 if hexadecimal value is returned to HL. 

5) A hex value was not returned to set HL to zero to signify 
failure, to user. 

6) The HL register is freed for other uses by transferring 
the hexadecimal parameter to memory location SAVE1. 

7) Return to caller. 

9) , 10) , 11) Establish address for all system routines used 
by using the Linkage to Common Routines table. 


NZ> EXM300 . GOT HEX VALUE 
HL, 0 ; DEFAULT VALUE 

( SAVE1 ) , HL; SAVE VALUE 


4) 

5) 

6 ) 
7) 


0A02DH 

0A039H 

0A033H 


SAVE AREA 
GET NAME ROUTINE 
ERROR ROUTINE 
GET HEX ROUTINE 


8) 
9) 
10 ) 
11 ) 
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APPENDIX C 

User Loading Instructions 


I/O 


ROS has the unique feature of initializing the baud rate of your 
I/O board. If you have a Cromemco TU-ART serial I/O board, ROS will 
initialize your I/O for baud rates of 9600, 2400, 300, 150, or 110. 
Other manufacturers have I/O boards which have software control of baud 
rates, consult their user manual to find out if they have this capa- 
bility. When ROS is initialized, hit the carriage return key several 
times until the ROS message is printed. This allows ROS to determine 
the correct baud rate. The I/O board which you use must conform to the 
drivers which can be found in Chapter 4. 


PROM 


First load the eight PROMs into your Cromemco BYTESAVER, making 
sure that you get the PROMs correctly placed. These PROMs have been 
preprogrammed and contain the Resident Operating System, ROS. Address 
your BYTESAVER at location 0A000H; this is done by using the DIP switch. 
For technical details refer to the BYTESAVER instruction manual. 

On your Cromemco ZPU card install a jumper wire connecting the 
two pins marked "jump enable". Set the jump address switch to A. By 
following the instructions in the next paragraph an automatic transfer 
will be made to the ROS. The jump enable section in your Cromemco ZPU 
manual gives complete details on the automatic jump feature. 

Insert the BYTESAVER and ZPU cards into the computer. Turn the 
power on and depress the run switch. When either the power is applied 
to the system or reset is depressed, control will be transferred to the 
Cromemco ROS. Depress the carriage control several times until the 
message: "CROMEMCO ROS V.2.0." is displayed. 


PAPER TAPE 

Appendix I gives the full instructions for loading the Cromemco 
ROS from a paper tape. The paper tape has been supplied in Cromemco' s 
binary checksummed tape format to insure high reliability. 
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APPENDIX D 

Special Functions of Keys 


ESCAPE 


ALT MODE 
Control S 


RUBOUT 


SHIFT O (back arrow) 


When this key is depressed during 
either input or output, any I/O is 
ceased and ROS enters the command 
mode . 

This key has the identical function 
as ESCAPE. 

This key only has an effect during 
output. When depressed, the output 
printing will be stopped. To resume 
printing, depress any key. 

This key deletes the previous charac- 
ter when inputting. On a TTY a back 
arrow will be printed. On some CRTs 
an underline will be printed. 

This key has the same function as 
RUBOUT. 


Control X 


This key will delete the line that 
is being inputted. A carriage return 
and a line feed will occur. 
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APPENDIX E 
Error Messages 


ERROR 
FILE ERROR 

FILE FULL 
NO CURRENT FILE 

FILE TOO LARGE 

DUP. NAMES 

NO MORE ROOM 

OK 

CS 


This is a general message for any 
error condition not covered by more 
specific error messages. 

This message is given by VFIL com- 
mand to say that the file contains 
an error. 

Example : 


3843 

FILE ERROR 

This message is given when the 
current file cannot contain the new 
line . 

This message is given when an opera- 
tion which automatically references 
a current file is tried when no file 
has been made current. 

This message is given by the VFIL 
command to indicate that the file 
is larger than the space allocated 
for it. 

This message occurs when trying to 
create a new file with a name al- 
ready used by a previous file. 

This message is given when there is 
no room left in the system RAM. 

This message is received after the 
paper tape is read correctly. 

This is received when a checksum 
error is detected from the paper 
tape record. 
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M This message is received when a 

memory error occurs while reading 
checksummed tape. 

SYMBOL TABLE FULL This message is given by the assembler 

when no space remains for an entry in 
the symbol table. 
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APPENDIX F 
Table Format 


Whenever a system subroutine uses a table, a particular format is 
followed. It is important for the user to understand this format when 
using a system subroutine. Some of these subroutines are PRNTTB , SEARCH, 
LOOK, INTTAB, and GTENT. The first byte of the table contains the length 
of the compare argument. The second byte of the table contains the 
length of an entire entry. The table is ended with a byte of zero. 


Example : 


TABLE : 

DB 

7,8 


1) 


DB 

'ENTRY 

1' ,7 

2) 


DB 

' ENTRY 

2' ,8 

3) 


DB 

0 


4) 

1) Each argument 

is seven 

bytes 

long, e.g. 1 

'ENTRY 1' is 

seven bytes. Each 

entry is 

eight 

bytes. The 

seven adds one 


byte . 

2), 3) Two seven byte arguments and their corresponding 
values seven and eight. 

4) End of table. 
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APPENDIX G 
System RAM 


SYSTEM RAM 




Bf-FE 


2443 


ORG 

DOOO 

0040 

2444 

RAM: 

DEFS 


D040 

2445 

STACK: 

EQU 


D040 

2446 

SYSRAM 

EGU 

DO 40 

0014 

2447 

TEMP: 

DEFS 

DO 04 

0005 

2448 


DEFS 

DO 59 

0053 

2449 

RBUFF : 

DEFS 


DOAC 

2450 

CURIO: 

EQU 

DOAC 

0002 

2451 

IDRIVE 

DEFS 

DOAE 

0002 

2452 

□DRIVE 

DEFS 

DOBQ 

0001 

2453 

NULLS: 

DEFS 

D0B1 

0001 

2454 

LINES: 

DEFS 

‘ DB2 

0001 

2455 

TERMWD 

DEFS 

JH3 

0001 

2456 

TAB 1 : 

DEFS 

DOB 4 

0001 

2457 

TAB2: 

DEFS 

DOB 5 

0001 

2458 

TAB3: 

DEFS 

DOB 6 

0002 

2459 

CURADR 

DEFS 

DOB 8 


2460 

i 


D0B8 

0002 

2461 

CURLEN 

DEFS 

DOB A 

DOBA 

2462 

2463 

/ 

BASE: 

EQU 

DOHA 

0000 

2464 

2465 

i 

STATUS 

EQU 

DOBA 

0001 

2466 


DEFS 

DOBB 


2467 

i 



0000 

2468 

BFORM: 

EQU 


0001 

2469 

CURFLE 

EQU 


0002 

2470 

SYM: 

EQU 

DOBB 


2471 

i 


DOBB 


2472 

; USER 

AREA 

DOBB 


2473 

/ 


DOBB 

0100 

2474 

USER : 

DEFS 

DIBB 

DFFF 

2475 

2476 

i 

ENDRAM 

: EQU 


2477 ; 


ODOOOH 

64 ; STACK AREA 

$ 

* ; START OF SYSTEM RAM 

20 , TEMP AREA (LEAVE PRIOR TO RBUF 

5 ; AREA FOR NUMBER OF LINE 

83 ; READ BUFFER 

$ ; CURRENT I/O PARMS 

2 i CURRENT INPUT DRIVER 

2 ; CURRENT OUTPUT DRIVER 

1 ; NUMBER OF NULLS 

1 ; NUMBER OF LINES/PAGE 

1 ; TERMINAL WIDTH 

1 ; TABS FOR ASSEMBLER 
1 

1 

2 ; CURRENT ADDRESS IN FILE 

2 ; CURRENT LENGTH 

♦ ; BASE FOR IX 

0 ; STATUS BYTE 

1 

0 ; FORM FLAG 

1 ; CURRENT FORM FLAG 

2 ; SYMBOL TABLE FLAG 


2S6 

ODFFFH ; END OF SYSTEM RAM 


DIBB 
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D1BB 

0002 

2478 

FLTBPT 

DEFS 

2 

i PTR TO FILE TABLE 

D1BD 

0002 

2479 

IOTBPT 

DEFS 

2 

; PTR TO I/O TABLE 

D1BF 

0002 

2480 

CUTBPT 

DEFS 

2 

; PTR TO CUSTOMER TABLE 

D1C 1 

0002 

2481 

SZTBPT 

DEFS 

2 

; PTR TO ASSEMBLER SYMBOL TABLE 

DIC3 

0002 

2482 

SZTEND 

DEFS 

2 

; END OF ALLOCATION, SYMBOL TABL 

D1C5 

0002 

2483 

TABEND 

DEFS 

2 

; END OF TABLES 

D1C7 


2484 

i 




D1C7 

0003 

2485 

FLTBST 

DEFS 

3 

; INITIAL FILE TABLE 

D1CA 

0013 

2486 

IOTBST 

DEFS 

19 

i INITIAL I/O TABLE 

D1DD 

0003 

2487 

CUTBST 

DEFS 

3 

; INITIAL CUSTOMER TABLE 

DltO 

0003 

2488 

SZTBST 

DEFS 

3 

; INITIAL ASSEMBLER SYMBOL TABLE 

D1E3 


2489 

i 




D1E3 


2490 


ORG 

FLTBST +2 

i CURRENT FILE AREA 

D1C9 

0006 

2491 

CURFIL 

DEFS 

6 

; CURRENT FILE NAME 

DICE 

0002 

2492 

CFSADR 

DEFS 

2 

; CURRENT FILE START ADDRESS 

D1D1 

0002 

2493 

CFLEND 

DEFS 

2 

i CURRENT FILE END ADDRESS 

D1D3 

0002 

2494 

CFLALL 

DEFS 

2 

.CURRENT FILE ALLOCATION ADORES 
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APPENDIX H 


Linkage to Common Routines 


l INK 

10 SYSTEM 







DJ D5 


2496 

• 





DJD5 


2497 

; LINKAGE TO SYSTEM 



DJ D5 


2498 

i 





DlDJl 


2499 


ORG 

START 



A OOO 

0003 

2500 

RESTRT : 

DEES 

3 

; RESTART SYSTEM 


A003 

0009 

2501 

I N I T : 

DEES 

9 

; INITIALIZE SYSTEM 


AOOC 

0003 

2502 

REENTR : 

DEES 

3 

; REENTER SYSTEM 


AOOi- 


2503 

, 





AOOf- 


2504 

i LINK AG 

E TO COMMON 

ROUTINES 


AOOf- 


2505 

i 





AOOf 

0003 

2506 

CAL I NT 

DEES 

3 

; CALL IN IT ROUTINE 


AO J2 

0003 

2507 

ACCES: 

DEES 

3 

; ACCESS COMMANDEFS 


AO 1 0 

0003 

2508 

SYSQUT 

DEES 

3 

i SYSTEM OUTPUT ROUTINE 


AO JO 

0003 

2509 

SYSIN. 

DEES 

3 

; SYSTEM INPUT ROUTINE 


AO J B 

0003 

2510 

P2HEX . 

DEES 

3 

; PRINT 2 HEX BYTES 


AOJ f- 

0003 

251 1 

P 1 HEX : 

DEFS 

3 

; PRINT 1 HEX BYTE 


AOOJ 

0003 

2512 

P2HEXS. 

DEFS 

3 

; PRINT 2 HEX BYTES AND 

SPACE 

AO 3 4 

0003 

2513 

PxHEXS: 

DEES 

3 

; PRINT 1 HEX BYTE AND SPACE 

A0P7 

0003 

2514 

PRTNUM: 

DEFS 

3 

i PRINT CHARACTERS <# IN 

D > 

AOPA 

0003 

2515 

READLN 

DEFS 

3 

; READ 1 LINE OF INPUT 


AOPD 

0003 

2516 

GNAME: 

DEFS 

3 

; GET A NAME FARM 


A 000 

0003 

2517 

SIOTAB: 

DEFS 

3 

i LOOK UP IN I/O TABLE 


A 000 

0003 

2518 

GTHEX.M 

DEFS 

3 

i GET HEX PARM 


AOPA 

0003 

2519 

GTDECM 

DEFS 

3 

; GET A DECIMAL PARM 


A007 

0003 

2520 

ERROR: 

DEFS 

3 

; ERROR ROUTINE 


AOOC 

0003 

2521 

MSG OUT 

DEFS 

3 

; OUTPUT MESSAGE 


AOOf- 

0003 

C- v/C C- 

PRN IVD : 

DEFS 

3 

; PRINT TABLE 


A 04 0 

0003 

2523 

COMPART 

DEFS 

3 

; COMPARE 


AC< AS 

0003 

2524 

SEARCH. 

DEFS 

"3 

i SEARCH TABLE 


AO AO 

0003 

2525 

LOOK . 

DEFS 

;~5 

; LOOK THRU TABLE 


AO A H 

0003 

c.' T? cu 6 

FILL' 

DEFS 

3 

; FILL AREA WITH VALUE 


AOAS 

0003 

-) r: o ~r 
•s~ - J CZ. f 

CLEAR 

DEFS 

3 

i FILL AREA WITH SPACES 


A05 1 

0003 

2.523 

MBLNK 

DEFS 

3 

; MOVE UNTIL DELIMETER 


A OSA 

0003 

2529 

SB LINK 

DEFS 

3 

; SKIP BLANKS 


aodv 

0003 

2530 

SCHAR : 

DEFS 

3 

i SKIP CHARACTERS UNTIL 

DELIM 

AOS A 

0003 

-> rr ' 2 j 

£^. •»_' l 

C MBLNK . 

DEFS 

3 

, CLEAR AND MBLNK 


AOSJ- 

0003 

c- \J e... 

CNUM 

DEFS 

3 

. CHECK NUMERIC 


AO AO 

0003 

") 

c. 

GETHEX 

DEFS 

"3 

■ -J 

GET HEX VALUE 
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A 063 

0003 

2534 

GDECM: 

DEFS 

3 

GET DECIMAL VALUE 

AO 66 

0003 

2535 

LEADER 

DEFS 

3 

WRITE LEADER 

A069 

0003 

2536 

EINTEL 

DEFS 

3 

END OF FILE INTEL TAPE 

A06C 

0003 

2537 

CHKCUR 

DEFS 

3 

CHECK CURRENT FILE 

A06F 

0003 

2538 

WINTEL 

DEFS 

3 

WRITE INTEL FORMAT 

A072 

0003 

2539 

PRTONE 

DEFS 

3 

PRINT ONE LINE USING TABS 

A075 

0003 

2540 

GTSTNG 

DEFS 

3 

GET A STRING 

A078 

0003 

2541 

INTTAB 

DEFS 

3 

INITIALIZE GTENT 

A07B 

0003 

2542 

GTENT : 

DEFS 

3 

GET AN ENTRY FROM TABLE 

A07E 

0003 

2543 

FUPACK 

DEFS 

3 

UNPACK 4 BCD DIGITS 

A081 

0003 

2544 

AFPACK 

DEFS 

3 

ADD 4 BCD DIGITS 

A084 

0003 

2545 

FPACK: 

DEFS 

3 

PACK 4 BCD DIGITS 

A087 

0003 

2546 

CDILM: 

DEFS 

3 

CHECK FOR DELIMETER 

A08A 

0003 

2547 

ADDAHL 

DEFS 

3 

ADD A TO HL 

AG8D 

A08D 

0003 

2548 

2549 

/ 

SPAC18 

DEFS 

3 

OUTPUT 18 SPACES 

A090 

0003 

2550 

SPAC16 

DEFS 

3 

OUTPUT 16 SPACES 

A093 

0003 

2551 

SPAC12 

DEFS 

3 

OUTPUT 12 SPACES 

A096 

0003 

2552 

SPACE6 

DEFS 

3 

OUTPUT 6 SPACES 

A099 

0003 

2553 

SPACE4 

DEFS 

3 

OUTPUT 4 SPACES 

A09C 

0003 

2554 

SPACE3 

DEFS 

3 

OUTPUT 3 SPACES 

A09F 

0003 

2555 

SPACE2 

DEFS 

3 

OUTPUT 3 SPACES 

A0A2 

2556 

SPACE: 

EQU 

* 

OUTPUT A SPACE 
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APPENDIX I 

Paper Tape Loading Instructions 


CUUNEUCO Z~B 0 ASSEMBLER V. 2. 0 


OOOO 

oooo 

OOOO 

oooo 

oooo 

oooo 

oooo 

oooo 

oooo 

oooo 

oooo 

oooo 

oooo 

^ooo 

00 

oooo 

oooo 

oooo 


0001 ; 

0002 ; TO LOAD YOUR PAPER TAPE COPY OF 

0003 ; CROMEIiCO ROS, FOLLOW THESE STEPS: 

0004 ; 

0005 i 1 ) BE SURE YOU HAVE 8K OF RAM AT LOCATION OAOOOH 

0006 < 2) BE SURE YOU HAVE RAM AT LOCATION O 

0007 i 3) KEY IN THIS LOADER AT LOCATION 0 

0008 ; 4) MOUNT THE PAPER TAPE IN THE READER 

0009 } 5 ) SET THE ADDRESS SWITCHES TO 0 

0010 « 6 ) PRESS STOP 

0011 » 7 ) PRESS EXAMINE 

0012 i B> PRESS RUN 

0013 ;9> START THE PAPER TAPE READER 

0014 ; 

0015 « WHEN THE PAPER TAPE HAS FINISHED READING, 

0016 ; CRQMEMCO ROS WILL BE STARTED. DEPRSS 

0017 i CARRIAGE RETURN UNTIL THE MESSAGE 

0018 ; 'CROMEMCD ROS V. 2. O ' IS TYPED. 


OOOO 


0019 

i 




oooo 


0020 

i IF DURING READING THE PAPER TAPE, A CHECKSUM 

oooo 


0021 

/ ERROR 

OCCURS, A 'C' 

WILL BE TYPED. 

oooo 


0022 

i START 

AGAIN 

AT STEP 

4. IF THERE IS BAD MEMORY 

oooo 


0023 

i A 'M' 

WILL 

be typed: 

CHECK YOUR MEMORY ! ! 

oooo 


0024 

; REPLACE ANY 

BAD MEMORY AND START AGAIN AT STEP 1. 

oooo 


0025 

i 




oooo 


0026 

i IF YOU ARE 

USING ANOTHER MANUFACTUREERS I/O BOARD 

oooo 


0027 

i WHICH 

NEEDS 

INITIALIZING, CHANGE THE INSTRUCTIONS 

oooo 


0028 

; AT THE LABLE INIT. 


oooo 


0029 

I 




oooo 


0030 


ORG 

0 



OOOl 

0031 

TTY: 

EQU 

1 

; TELETYPE DATA PORT 


oooo 

0032 

TTS: 

EQU 

0 

; TELETYPE STATUS PORT 


0040 

0033 

DTR : 

EQU 

40H 

; TELETYPE READY BIT 

oooo 


0034 

i 




oooo 


0035 

> INITIALIZE 

TELETYPE 


oooo 


0036 

i 




oooo 

97 

0037 

INIT: 

SUB 

A 

; SET TO DEVICE A ON CROMEMCO 

OOOl 

D3 52 

0038 


OUT 

54H, A 


0003 

3C 

0039 


INC 

A 

; RESET TU-ART 
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0004 

D3 

02 


0040 


OUT 

2, A 


0006 

D3 

00 


0041 


OUT 

TTS, A 

i INIT BAUD RATE TO 1 10 

0008 

31 

00 

02 

0042 


LD 

SP, 0200H 

INITIALIZE STACK POINTER 

OOOB 




0043 

/ 




OOOB 




0044 

; START 

READING TAPE 


OOOB 




0045 

# 




OOOB 

CD 

43 

00 

0046 

WAIT: 

CALL 

GCHAR 

GET A CHARACTER 

OOOt- 

E6 

7F 


0047 


AND 

7FH 


0010 

FE 

3A 


0048 


CP 

/ . / 

CHECK FOR A COLON 

0012 

20 

F7 


0049 


JR 

NZ, WAIT 

NOT FOUND, WAIT FOR A COLON 

0014 

CD 

4C 

00 

0050 


CALL 

GTBYT 

GET COUNT OF CHARACTERS 

0017 

A7 



0051 


AND 

A 

CHECK FOR END OF TAPE 

0018 

CA 

00 

AO 

0052 


JP 

Z, OAOOOH 

FOUND 

OOIB 

47 



0053 


LD 

B, A 

SAVE COUNT 

OOIC 

5F 



0054 


LD 

E, A 

INITIALIZE CHECKSUM 

OQ1D 

CD 

4C 

00 

0055 


CALL 

GTBYT 

GET HIGH BYTE OF ADDRESS 

0020 

67 



0056 


LD 

H, A 


0021 

CD 

4C 

00 

0057 


CALL 

GTBYT 

GET LOW BYTE OF ADDRESS 

0024 

6F 



0058 


LD 

L, A 


0025 

CD 

4C 

00 

0059 


CALL 

GTBYT 

GET RESERVED BYTE 

0028 

CD 

4C 

00 

0060 

LOOP: 

CALL 

GTBYT 

GET DATA BYTE 

002B 

77 



0061 


LD 

(HL), A 

STORE BYTE 

0020 

BE 



0062 


CP 

(HL) 

MAKE SURE STORED 

002D 

20 

OE 


0063 


JR 

NZ, MERROR 

MEMORY ERROR 

002F 

23 



0064 


INC 

HL 

PT TO NEXT MEMORY LOCATION 

0030 

10 

F6 


0065 


DJNZ 

LOOP 

COUNT DOWN AND LOOP 

0032 

CD 

4C 

00 

0066 


CALL 

GTBYT 

GET CHECKSUM 

0035 

7B 



0067 


LD 

A, E 


0036 

A7 



0068 


AND 

A 


0037 

28 

D2 


0069 


JR 

Z, WAIT 

CHECKSUM OK 

0039 

3E 

43 


0070 


LD 

A, 'C ' 

CHECKSUM ERROR 

003B 

18 

02 


0071 


JR 

COUT 

OUTPUT ERROR CODE 

0030 




0072 

i 




003D 

3E 

4D 


0073 

MERROR: 

LD 

A, 'M' 

MEMORY ERROR 

0O3F 

D3 

01 


0074 

GOUT: 

OUT 

TTY, A 

OUTPUT ERROR CODE 

0041 

18 

FE 


0075 


JR 

$-2 

LOOP UNTIL USER STOPS 

0043 




0076 

/ 




0043 

DB 

00 


0077 

GCHAR : 

IN 

A, TTS 

GET TTY STATUS 

0045 

E6 

40 


0078 


AND 

DTR 


0047 

28 

FA 


0079 


JR 

Z, GCHAR 

LOOP UNTIL CHARACTER 

0049 

DB 

01 


0080 


IN 

A, TTY 

GET CHARACTER 

004B 

C9 



0081 


RET 



004C 




0082 

I 




004C 

CD 

43 

00 

0083 

GTBYT : 

CALL 

GCHAR 

GET A CHARACTER 

004F 

4F 



0084 


LD 

C, A 

SAVE CHARACTER 

0050 

83 



0085 


ADD 

E 

ADD TO CHECKSUM 

0051 

5F 



0086 


LD 

E, A 

SAVE CHECKSUM 

0052 

79 



0087 


LD 

A, C 

RESTORE CHARACTER 

0053 

C9 



0088 


RET 







0089 


END 
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APPENDIX J 
Glossary 

ASCII American Standard Code for Informa- 

tion Interchange. A method of en- 
coding bits to represent a character. 

Carriage Return Character When using the teletype for output 

and a byte containing 13 is sensed, 
a carriage control will occur, i.e. 
a return to column one. 

Checksum The checksum is the negative of the 

sum of all eight bit bytes in the 
record after the record mark evalu- 
ated modulus 256. In other words, 
if all the eight bit bytes are added 
together, ignoring carries out of an 
eight bit sum, and then the checksum 
is added, the result is zero. 

Command String A series of characters set off by the 

string symbol ( ' ) which contains a 
system command and its parameters. 

Example : 

'EXEC,AjW 

Control Characters All hexadecimal codes from 00 to IF 

are considered available as control 
characters, e.g. linefeed. 

Delimiter Any character which will terminate 

a parameter or string. Frequently, 
a delimiter functions as a separator, 
e.g. the comma in EXEC , A000 separates 
EXEC from A000. 

In order to use an Input/Output de- 
vice, some body of code must: 1) 

check to see if the device is avail- 
able, 2) connect the computer to the 
device, 3) prepare the device for a 


Driver 
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Initialization 


Linefeed 


Memory boards 


Mnemonic Name 


Null 


Object Code 


Preservation of Registers 


PROM 


transfer of data, 4) properly dis- 
connect the device at the termination 
of the transfer of data. A driver 
may do all of the above. A simple 
device such as a teletype (TTY) has 
a very simple driver. In contrast 
a disk driver can be quite complex. 

Basically, initialization clears all 
the tables and sets SYSIO to its 
standard setting. 

When using the teletype for output, 
if a byte containing 10 is sensed, 
a paper advance of one line will 
occur . 

A board on which semiconductor 
memory modules can be mounted. This 
board can plug into a master board 
called a mother board. 

A name which the user can easily 
associate with a desired machine 
language op-code. 

On a paper tape, a null is a frame 
that will not contain data. 

The machine readable code which was 
translated from the user's source 
code . 

When a call is made to a subroutine, 
the routine or the call may change 
the contents of several registers. 

The user may need to preserve the 
contents of the registers by saving 
them especially in the stack. Later 
the registers can be restored from 
the stack or whatever area they were 
saved in. 

Programmable Read Only Memory. Once 
information is written into a PROM 
by a special burn command, the PROM 
contents cannot be easily changed. 

A Cromemco PROM can be erased by 
radiating the PROM with an ultra- 
violet source. 


Pseudo-op 


A command, typically to an assembler, 
which will not produce any executable 
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RAM 


Region 


ROS 


Source Code 
Swath 
S length 
TTY 


code. For example, a TITLE command 
will cause a page eject and place a 
Title on the next page of an assembler 
listing. A command like TITLE is not 
like a load instruction which produces 
code . 

Random Access Memory. An area in 
main storage which can be both written 
into and read from. 

A logical partition, hunk of memory. 
The user's file can be said to be 
assigned the region from 1000U to 
1500H in memory. 

The Cromemco Resident Operating 
System once loaded needs no other 
external routines to operate. In 
contrast a disk based operating 
system has a resident portion, the 
nucleus, and the bulk of the system 
on a disk. 

The user written code. 

The number of bytes to be processed. 
Swath length. 

A teletype. 
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APPENDIX K 
ASSEMBLER ERROR CODES 


There are ten classes of programming errors that can 
be detected by the Cromemco assembler. If a line of code 
is in error, this will be indicated by an error code letter 
just to the left of the line number in the assembly listing. 
The definitions of these ten error codes are given below: 


A 

D 

L 

M 

0 

P 

R 

S 

U 

V 


Argument error 
Double definition 
Lable error 
Missing lable 
Op-code error 
Phase error 
Range error 
Syntax error 
Undefined 
Value error 



